home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / comm2 / pssntr11.lha / PassWordEntryV1.1.Doc < prev    next >
Text File  |  1994-03-21  |  7KB  |  155 lines
  1.                      PassWord Entry v1.1
  2.                      ~~~~~~~~~~~~~~~~~~~
  3.                      For MAX's BBS v1.52
  4.                      ~~~~~~~~~~~~~~~~~~~
  5.                         By Greg Fitch
  6.                         ~~~~~~~~~~~~~
  7. ---------------------------------------------------------------------
  8.                             Legal:
  9. ---------------------------------------------------------------------
  10.     This Door is freeware, so if you paid for it then please 
  11. let me know where you got it from and what you paid.
  12. This archive must be as is was when made with the exception of
  13. origin text files that may be added.
  14.  
  15. YOU RUN THIS DOOR AT YOUR OWN RISK I EXCEPT NO RESPOSABILITY
  16. FOR ANY HARM IT MAY CAUSE AT ALL.
  17.  
  18. The Archive must contain the following files:
  19.  
  20. Doors/
  21.       PassWordEntryV1.0.Doc (Your Reading It)
  22.       PassEnter.Config      (The Config File)
  23.       PassEnter/
  24.                PassWordEntryV1.0     (The Door ItSelf)
  25.                Welcome.text          (Ansi To Display On Entry)
  26.                Enter.text            (Ansi To Display On Access) 
  27.                Failed.text           (Ansi To Display On Failure)
  28.  
  29. ---------------------------------------------------------------------
  30.                           What it Does:
  31. ---------------------------------------------------------------------
  32.     This door is a security door for Max's BBS and contains
  33. features from both SecurityGate and Bouncer, it lets you set up a
  34. config file and your own Ansi screens, it looks for the password
  35. for the users trying to get through it in the Comment field of
  36. Max's user config, they are then asked to enter the password and
  37. if they get it right in they go, but if they get it wrong they
  38. have two more goes at it, if they just hit return the will be put
  39. back to the menu they were on if they fail to enter the correct
  40. password after 3 tries they will be shown an Ansi screen then
  41. asked if they wish to leave a message to the SysOp if they
  42. choose no they will be logged off, if they choose yes they will
  43. be able to leave a message then they will be logged off.
  44. If they get the password right they will be given another Ansi
  45. screen then sent to the menu or what ever you have chosen in the
  46. config. You can also set a minimum auto pass level this will let 
  47. all users over this level go straight in without entering a password
  48. "handy for sysops" the door will also write a log file and add to
  49. it when ever someone uses it (except auto pass users) the log
  50. shows what the user did (hit return and "QUIT", made it into the
  51. menu "ENTERED" or got logged off "FAILED". The config file also
  52. lets you put in the paths to the data files and log file for the
  53. door and put in 2 lines of text for "QUIT" and "FAILED" these are
  54. to make it more configurable for you.
  55.  
  56. ---------------------------------------------------------------------
  57.                           Installation:
  58. ---------------------------------------------------------------------
  59.     Easy to do just copy the whole PassEnter directory across
  60. to your doors directory and "the config file must be in Doors:".
  61. Then add it to your Menus config as a standard door.
  62.  
  63. Eg. Key  34  0  0  10000  Doors:PassEnter/PassWordEntryV1.0
  64.  
  65. You can also edit the ansi screens to look how you want, but don't
  66. forget the screen clearing code at the top and the %Z at the bottom
  67. with the exception of the Welcome text (don't put the %Z on this).
  68.  
  69. To let a user have access just enter the password for them into
  70. the Comment field of the user editor of Max's you can have one
  71. password for all users that have access or a different one for
  72. each user (I use their own password) and the entry must look like
  73. this:
  74.  
  75.   >password<
  76.  
  77. yes you must put the > and the < in or it will not find the password,
  78. you can put it any where in the comment field as it will find it
  79. even if there is other text in there or even if you are using
  80. SecurityGate's #-password-# so you can run these two programs together
  81. with no problems.
  82.  
  83. The only other thing is the config file and it looks like this:
  84. ---------------------------------------------------------------------
  85. 2
  86. 35
  87.  
  88. 5000
  89. Greg Fitch
  90. 0
  91. Doors:PassEnter/
  92. BBS:LogFiles/
  93. Ok your out of here!
  94. Sorry you FAILED logging you off
  95.  
  96. ----------------------------------------------------------------------
  97. The PassWord Entry Door Will Only Look At The First 10 Lines
  98. ----------------------------------------------------------------------
  99.                    What each line is:
  100.  
  101. Line  1 = Menu Function 1-33
  102. Line  2 = The Extra Info for Menu Function.
  103. Line  3 = FileName/Name/Dest/Path For Menu Function
  104. Line  4 = Minimum automatic pass through level.
  105. Line  5 = Name for all messages to go to (USUALY THE SYSOP'S NAME).
  106. Line  6 = Section number for messages to go to.
  107. Line  7 = Path to ANSI data files (MUST END IN A ":" OR A "/").
  108. Line  8 = Path to log files (MUST END IN A ":" OR A "/").
  109. Line  9 = Text to type if they just hit return to quit.
  110. Line 10 = Text to type if they failed to gain access.
  111. ---------------------------------------------------------------------
  112. you can just edit it in a text editor to match your bbs.
  113.  
  114. ---------------------------------------------------------------------
  115.                            Known Bugs:
  116. ---------------------------------------------------------------------
  117.     May turn BBS screen to the color of workbench but this
  118. may be dependent on memory addresses I think as I have a few that
  119. do this (ones I didn't write) this can be cured when it happens
  120. by clicking the screen to the back then and bringing it to the
  121. front again, this is not realy a bug and may be somthing to do
  122. with the compiler or librarys if you know what causes this
  123. please let me know and I will try to fix it.
  124. It has no other bugs that I know of.
  125.  
  126. ---------------------------------------------------------------------
  127.                              History:
  128. ---------------------------------------------------------------------
  129.     V1.1 Added Date and time to the log file.
  130.     V1.0 First release!
  131.  
  132. ---------------------------------------------------------------------
  133.                               Credits:
  134. ---------------------------------------------------------------------
  135.     Thanks to all the other SysOps that have done up the source
  136. codes for Max's BBS as that helped me sort out this one.
  137.  
  138. ---------------------------------------------------------------------
  139.                              Bug Reports:
  140. ---------------------------------------------------------------------
  141.                     XyonicS BBS  +61-7-808-4806
  142.                           HOURS  8:30pm - 7:00am 7days
  143.                         XMAXNET  292:363/805.0
  144.                         MEGANET  929:181/849.0
  145.  
  146. ---------------------------------------------------------------------
  147. If you have an idea for a new door then please let me know and I will
  148. see what I can do.
  149.  
  150.                                  Thanks.
  151.  
  152.                                         Greg...
  153.  
  154.  
  155.